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Assembly 

Attach the screen 


This is a delicate step, so ensure to take your time and 
ask for help if you need it. 



Feed the ribbon cable through the hole in the PCB and 
turn it over. Locate the ribbon connector and gently 
pull the black section up to the white line on the PCB. 



Carefully insert the ribbon into the ribbon connector 
then gently ease the black section back closed 




Turn the board back over to the front and remove the 
3M backing from the back of the screen, exposing the 
adhesive. Ensure the screen is aligned with the outline on 
the PCB as you stick it into place. You can use the green 
tab to remove the screen protector. 


Attach the Battery 



On the back of the board attach one half of the velcro dot 
to the space in-between the microchips, and the other 
to the top of the battery. Then attach the battery to the 

board and plug it in. 

If you are missing anything please go to the badge tent. 






Programming 

Set Up 



1. Plug In 2. Turn On 3. Terminal 


When you connect your badge to your computer you will 
need to communicate with it, you do this using a serial 

terminal (a place to type text commands) at a 115200 baud rate 
(ensures badge and computer are speaking the same language - kinda) 

Linux 


minicom D dev ttyACMO b 15200 


Mac 


screen dev tty.usbmodemTiLDA2 


Windows 

Open device manager to find the COM port your badge is 
using. We suggest using PuTTy to connect to the badge. 








Everything is Broken!!? 


Your badge may be corrupted, in order to reset it press the 
reset and menu button at the same time. Release reset 
first and then release menu when both the green and red 
LEDs are lit. If you're still stuck come to the badge tent. 



rams 


Your badge will show up as a usb device on your 
computer. The main.py file here is the one that will be run. 


The Appstore 


To upload your creations to the public appstore 

1. Fork the github repo 
https://github.com/emfcamp/Mk4-Apps 

2. Add your app 

3. Submit a pull request 

If you're unsure how to do this, some instructions can be 
found here: https://help.github.com/articles/creating-a- 
pull-request/ 


More Information 


This guide is only a short intro to using the badge. To 
learn more about programming the badge please go here: 

https://badge.emfcamp.org/ or attend a workshop. 


m 



Micropython 

All the code you write for the badge is in micropython - a 
condensed version of python, https://micropython.org/ 


Sensors 


Your badge has a number of sensors, allowing you to 
sense the Temperature, Humidity and Ambient Light 
Level. They are automatically read in the background 
every half a second. 

Temperature Sensor 

There are two temperature sensors on your badge, one on 
the standalone TMP102, and the other integrated into the 
HDC2080 humidity sensor. It returns a value in °C. 


»> tilda Sensors 

»> print(Sensors.get_tmp_temperature()) 

21.32 

»> print(Sensors.get_hdc_temperature()) 

. 


Humidity Sensor 

The HDC2080 humidity sensor can be used to read the 

relative humidity percentage. 


»> tilda Sensors 

»> print(Sensors.get_hdc_humidity()) 

63.31 
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Light Level Sensor 

The OPT3001 light sensor can be used to read the 
ambient light level. It returns a value in Lux. 


»> tilda Sensors 

»>Sensors.get_lux() 

201.04 


Magnetic Flux Sensor 


»> hall_effect 

»> hall_effect.get_flux() 

2055 


Phone 




-» 



You should have received a SIM card with your badge. 
Carefully remove it from its exterior and then pop out the 
middle size (Micro). Now insert it into the SIM slot located 
on the back of your badge. 
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Send an SMS Message 


»> lib sim800 

»> sim800.sendsms(" 

"FM TEXTING YOU FROM A BADGE HOW WEIRD IS THAT”) 


Check for new SMS' 


»> lib sim800 

»> sim800.newsms(): 

»> print ("New SMSSSSES!”) 

»> sms sim800.1istsms(): 

»> print(sms) 


Make a Phone Call 


»> lib sim800 

»> sim800.call(" )”) 


End a Phone Call 


»> lib sim800 

»> sim800. iangup() 
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Buttons 


The buttons encrusting your badge can be read directly, or 
hooked up to run functions when pressed. 


»> tilda Buttons 

»> # You can list the button names and functions 
using the dir function however for clarity 
only the button names are shown below 
»> dir(Buttons) 

[BTN_0, BTN_lj BTN_2j BTN_3, BTN_6 J BTN_5, BTN_4 J 
BTN_7j BTN_8, BTN_9, BTN_A, BTN_B, BTN_Call, BTN_End, 
BTN_Hashj BTN_Menu, BTN_Star, BTN_Call, 10Y_Center, 
30Y_Up, 10Y_Down J 30Y_Left, DOY_Right] 



Reading the buttons 

I 

»> tilda 

»> Buttons. is_ 

: alse 

Buttons 

pressed (Buttons.BTN_Call) 

Function on button press 


»> tilda Buttons 


»> Buttons. enable_interrupt( 

Buttons.BTN_Callj 

lambda button_id:print( f Ring Ring- 1 ), 

on_press True, 
on_release F )j 

Ring Ring 
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LEDs 


Your badge has 4 LEDs onboard, two single colour LEDs in 
Red and Green, and two RGB NeoPixel LEDs. 

Single Colour LEDs 

The two single colour LEDs can be accessed by LED.RED 
and LED.GREEN. 


»> tilda LED 

»> LED(LED.RED).on() #turns the red LED on 
»> LED(LED.RED).off() ttturns the red LED off 
»> LED(LED.RED).toggle() tftoggles the LED's state 


NeoPixel LEDs 

The NeoPixels on your badge can be set to any RGB 
colour by specifying its hex code. You can find a colour's 
hexcode using an online colour picker tool. 


»> machine Neopix 

»> n Neopix() 

»> n.display([ xff0000j x00ff00]) 

»> # Two values are used, one for each of the 

NeoPixels, 0xff0000 represents red and 0x00ff00 
represents green. 









Screen 


This code snippet shows you how to clear the screen, 
display some text, and an image using the ugfx library. 


»> wifi, ugfx, http 

»> ugfx.initQ 
»> ugfx.clearQ 

»> ugfx.text( , , "Loading...”, ugfx.BLACK) 

»> image http.get("http: s3.amazonaws.com tilda 
badge sponsors screen.png”). raise_for_status(). 
content 

»> ugfx.display_image( , ,bytearray(image)) 



You can find more information about the ugfx library at 
https://badge.emfcamp.org/wiki/TiLDA_MK3/ugfx 
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Torch Tutorial 


Hardware 


We're going to create an LED torch for seeing our way 
around the camp. 

You can collect an LED and a resistor from the badge tent. 
First, grab the resistor. Bend the legs over so they fit in 
the holes in the board. It doesn't matter way round the 
resistor goes. 



Flip over your board and solder the resistor in place, then 
trim down the legs to be flush against the board. 



Next, the LED. Look for a flat side on the LED and match it 
up with the flat side on the board. Pull your LED out about 
a centimetre and bend it so it will point towards the floor. 
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Flip the board over and solder the LED into place. Trim 
the legs flush with the board. 


Software 


We can turn the torch pin on manually to test 


»> machine Pin 

»> torch Pin(Pin.GPIO_FET) 

»> torch. on() 

»> torch. off() # Only type this line when you're 
ready to turn the torch off 


App 


Of course, this is a bit too much to type in every time you 
want to turn your torch on or off. To take care of this, 
we’ve created a "Tilda Torch” app in the appstore to toggle 
the app on and off. The source code is available here: 

https://github.com/emfcamp/Mk4-Apps/tildatorch/ 
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